home *** CD-ROM | disk | FTP | other *** search
/ Dr. Windows 3 / dr win3.zip / dr win3 / WINSOUND / WMP004B.ZIP / S3MRIP.DOC < prev    next >
Text File  |  1993-07-17  |  3KB  |  78 lines
  1.  
  2.                       ┌────────────────────────────┐
  3.                       │           S3MRip           │
  4.                       │ (c) James Holderness 1993  │
  5.                       └────────────────────────────┘
  6.  
  7. Introduction
  8. ────────────
  9. S3MRIP is a simple utility for ripping S3M files from demos. It will only
  10. work if the executable file does not use any compression (e.g. PKLITE). If
  11. you use it to try and rip an S2M file, it will probably just hang your
  12. machine.
  13.  
  14. Usage
  15. ─────
  16. S3MRIP filename
  17.  
  18. where filename is the name of the demo's executable file which may contain
  19. some S3M files. If any of the modules in the demo contain more than one
  20. song, each song will be extracted as a seperate file.
  21.  
  22. Nameing conventions
  23. ───────────────────
  24. The files extracted are named in the following manner: The name of the
  25. executable is truncated to 6 characters. Then each module is assigned a
  26. letter consecutively which is appended to that name (the first module gets
  27. the letter 'A', the second, the letter 'B', etc.). Then each song in a
  28. particular module is also assigned a letter, which is also appended to the
  29. name.
  30.  
  31. For example, if you are ripping from a demo called EXAMPLE.EXE, which
  32. contained 3 modules, and the second module was made up of 2 seperate
  33. songs, the files extracted would be named: EXAMPLAA.S3M (the first module),
  34. EXAMPLBA.S3M (the first song in the second module), EXAMPLBB.S3M (the second
  35. song in the second module), and EXAMPLCA.S3M (the third module).
  36.  
  37. Disclaimer
  38. ──────────
  39. Please note that this is not meant to be used for any illegal purposes. It
  40. was written so that people that enjoy the S3M music found in demos could
  41. listen to it without having to watch the whole demo. It is also useful in
  42. cases where someone's machine may not be powerful enough to run the demo
  43. with sound. It may or may not be legal for you to distribute any mods you
  44. may have ripped from a demo, so do not do so unless you have permission
  45. from the author(s).
  46.  
  47. Technical notes
  48. ───────────────
  49. Any module ripped using this utility will not necessarily be the same as
  50. the module in the demo, since the program attempts to remove any unused
  51. samples (this is especially necessary when splitting up multiple songs in
  52. one module). This has the advantage of possibly making the modules a
  53. little smaller, but there is also a chance that a module may be ripped
  54. incorrectly.
  55.  
  56. What demos use S3M files
  57. ────────────────────────
  58. The only demos that I know of that use S3M files are made by the PC group
  59. "Future Crew". The following demos by them are known to contain S3M files:
  60. Fishtro, Unreal, The Party, and Panic.
  61.  
  62. Note that when ripping files from the Unreal demo, there is one file that
  63. will be created that is not really a song and can be deleted. It is the
  64. second song in the third module (the filename should be UNREALCB.S3M).
  65.  
  66. Contacting me
  67. ─────────────
  68. Don't know why anyone would want to do this, but I can be reached at the
  69. following addresses:
  70.  
  71. Internet: holderne@beastie.cs.und.ac.za
  72.   (This is the best one to try, but it may not last that long)
  73. Fido: James Holderness @ 5:7103/7
  74.   (I'm quite slow replying here, and FIDO often looses stuff)
  75. Snailmail: P.O.Box 1235, Westville, 3630 South Africa
  76.   (I hardly ever reply, and when I do, it takes years)
  77.  
  78.